Автор перевода: Майкл "Antares" Клишин	Предыдущая | Следующая | Оглавление

MMExecute()

Доступность

Flash Player 7.

Синтаксис

MMExecute("Flash JavaScript API command;":String)

Параметры

Flash JavaScript API command Любая команда, которая может использоваться в Flash JavaScript (JSFL) файле.

Возвращает

Строковое представление результата, если таковое имеется, отправленное JavaScript запросу.

Описание

Функция, позволяющая вызываеть Flash JavaScript API (JSAPI) команды из ActionScript. Во Flash MX2004 функция MMExecute может вызываться только роликом, используемым как Flash Panel (файл должен храниться в директории WindowSWF), диалоговым окном XMLtoUI или же Custom UI компонента. JSAPI команды не работают в плеере, в режиме тестирования ролика или где-либо еще за пределами среды разработки.

Flash JSAPI предоставляет несколько объектов, методов и свойство для дублирования или имитации команд, которые пользователь использует в среде разработки. Используя JSAPI, вы можете писать скрипты, расширяющие Flash сразу в нескольких направлениях: добавляя команды в меню, манипулируя объектами на Сцене, повторяя последовательности команд и так далее.

Чаще всего пользователь запускает JSAPI скрипт, выбрав пункт меню Commands > Run Command. Однако, вы можете использовать эту функцию в ActionScript, вызывая JSAPI команду напрямую. При использовании MMExecute() в скрипте в первом кадре вашего ролика, команда исполнится, как только ролик загрузится.

Для более подробной информации по JSAPI зайдите на www.macromedia.com/go/jsapi_info_en.

Пример

Следующая команда выведет число объектов в Библиотеке текущего документа в окно Output. Вы можлжны запускать этот пример как Flash панель, потому что Flash ролики не могут использовать MMExecute, если они запущены вне среды разработки или в режиме тестирования ролика.

• Введите следующий код в первый кадр главного Таймлайна пустого Flash документа:

  var numLibItems = MMExecute("fl.getDocumentDOM().library.items.length");
  var message = numLibItems + " items in library";
  MMExecute('fl.trace("' + message + '");');
  

• Сохраните FLAфайл в директории WindowSWF внутри директории Configurationи выберите File > Publish (или же сохраните где пожелаете и опубликуйте SWF в указанную директорию).
• Перезапустите приложение (это необходимо сделать только при первом добавлении файла в директорию WindowSWF).

Теперь Вы можете вызывать свой файл из меню Window > Other Panels.

ActionScript-функция trace не работает при вызове из Flash панели; этот пример использует версию JavaScript fl.trace для вывода. Возможно, более легким путем будет вывести результат работы MMExecute в текстовое поле вашего Flash Panel ролика.

Посмотреть комментарии LiveDocs		Предыдущая | Следующая | Оглавление